DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Le déblocage n'a pas été effectué
  • Déblocage d'un fichier
  • Position dans le fichier
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Débloque entièrement ou partiellement un fichier externe. Le fichier a été préalablement bloqué par la fonction <Variable FichierDisque>.Bloque.
Attention : Le déblocage peut être effectué uniquement si la partie à débloquer correspond à la partie bloquée.
Exemple
// Ouverture d'un fichier externe
MonFichierTxt est un FichierDisque
ResDébloque est un booléen
SI MonFichierTxt.Ouvre("C:\MesRépertoires\Fichier.txt", foLectureEcriture) = Vrai ALORS
// Blocage du fichier
ResBloque = MonFichierTxt.Bloque()
...
// Déblocage du fichier externe
ResDébloque = MonFichierTxt.Débloque()
FIN
Syntaxe
<Résultat> = <Fichier manipulé>.Débloque([<Premier octet à débloquer> [, <Nombre d'octets à débloquer>]])
<Résultat> : Booléen
  • Vrai si le déblocage a été effectué,
  • Faux dans le cas contraire.
<Fichier manipulé> : Variable de type FichierDisque
Nom de la variable de type FichierDisque initialisée avec la fonction <Variable FichierDisque>.Ouvre ou <Variable FichierDisque>.Crée.
<Premier octet à débloquer> : Entier optionnel
Position du premier octet (caractère) à débloquer (0 correspond au premier octet du fichier).
<Nombre d'octets à débloquer> : Entier optionnel
Nombre d'octets (de caractères) à débloquer.
Remarques

Le déblocage n'a pas été effectué

La fonction <Variable FichierDisque>.Débloque renvoie Faux si le déblocage n'a pas été effectué. Le déblocage peut être effectué uniquement si :
  • le fichier externe est ouvert.
  • l'identifiant du fichier est valide.
  • le fichier ou les octets à débloquer sont bloqués à l'identique. Par exemple, si seule une partie du fichier a été bloquée, cette même partie doit être débloquée. Si le fichier a été bloqué en totalité, il n'est pas possible de débloquer uniquement une partie du fichier.
  • le fichier ou les octets à débloquer ont été bloqués par la même application et depuis le même poste.

Déblocage d'un fichier

  • Le fichier est débloqué dans sa totalité si les paramètres <Premier octet à débloquer> et <Nombre d'octets à débloquer> ne sont pas précisés.
  • Le fichier est débloqué du premier octet à débloquer (paramètre <Premier octet à débloquer>) jusqu'à la fin si le paramètre <Nombre d'octets à débloquer> n'est pas précisé.
  • Un fichier bloqué (ou partiellement bloqué) sera automatiquement débloqué lors de sa fermeture.

Position dans le fichier

A l'ouverture d'un fichier, la position en cours correspond :
  • soit au premier octet du fichier (par défaut),
  • soit au dernier octet du fichier si le fichier est ouvert en "ajout" (constante foAjout).
Cette position peut être modifiée par la fonction <Variable FichierDisque>.Positionne.
La position en cours n'est pas modifiée par l'exécution de la fonction <Variable FichierDisque>.Débloque.
Classification Métier / UI : Code métier
Composante : wd290std.dll
Version minimum requise
  • Version 28
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/09/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale